docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework by Copilot · Pull Request #53565 · dotnet/docs

Copilot · 2026-05-05T19:05:17Z

Nine Microsoft.Extensions.* libraries are now part of the .NET 11 base shared framework, making explicit PackageReference entries unnecessary for net11.0-only projects and triggering NU1510 warnings. Projects pinned to old package versions may encounter runtime failures (MissingMethodException, TypeLoadException) due to accumulated breaking changes between those versions and 11.0.

Changes

New article docs/core/compatibility/extensions/11/extensions-in-shared-framework.md
- Titled "Some Microsoft.Extensions packages included in shared framework"
- Package names in "Previous behavior" link to their respective NuGet pages
- Covers NU1510 warning and resolution: remove the PackageReference for net11.0-only projects
- Clarifies multi-targeting behavior: NU1510 is not raised when the package is still needed for an older TFM (e.g., net10.0;net11.0); includes a conditional PackageReference example for projects that want to be explicit
- Catalogs related breaking changes that may surface when upgrading old package versions (DI Abstractions, Logging Abstractions, Hosting Abstractions)
docs/core/compatibility/11.md — added entry to Extensions table
docs/core/compatibility/toc.yml — added entry under Extensions/.NET 11

Internal previews

📄 File	🔗 Preview link
docs/core/compatibility/11.md	docs/core/compatibility/11
docs/core/compatibility/extensions/11/extensions-in-shared-framework.md	docs/core/compatibility/extensions/11/extensions-in-shared-framework
docs/core/compatibility/toc.yml	docs/core/compatibility/toc

…d framework (.NET 11) Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

…rticle Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot

Pull request overview

Adds a new .NET 11 compatibility article documenting that several Microsoft.Extensions.* assemblies are now provided by the shared framework (triggering NU1510 when referenced explicitly), and wires the new article into the .NET 11 compatibility index and TOC.

Changes:

Added a new breaking change article describing the shared-framework inclusion of nine Microsoft.Extensions.* libraries and related guidance.
Linked the new article from the .NET 11 Extensions compatibility index page.
Added the new article to the compatibility TOC under .NET 11 > Extensions.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
docs/core/compatibility/extensions/11/extensions-in-shared-framework.md	New breaking change article describing NU1510 implications and recommended actions for framework-provided `Microsoft.Extensions.*` assemblies.
docs/core/compatibility/11.md	Adds the new Extensions breaking change to the .NET 11 index table.
docs/core/compatibility/toc.yml	Adds a TOC entry for the new .NET 11 Extensions breaking change article.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

…mework.md

gewarren · 2026-05-05T19:28:42Z

@copilot Please respond to remaining feedback.

…geting guidance Agent-Logs-Url: https://github.com/dotnet/docs/sessions/b2a02110-0ef1-4f11-be45-fec2c67a75d5 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot · 2026-05-05T19:31:18Z

@copilot Please respond to remaining feedback.

Addressed in commit 2074387:

Package names in "Previous behavior" now link to their NuGet pages.
Front matter title updated to match the H1 ("Some Microsoft.Extensions packages...").
"Recommended action" section now distinguishes single-target (net11.0 only — remove the PackageReference) from multi-targeted projects (net10.0;net11.0 — NU1510 isn't raised because the package is still needed for the older TFM; NuGet selects the right assembly automatically, with an optional conditional reference example).

svick · 2026-05-12T09:21:18Z

+
+# Some Microsoft.Extensions packages included in shared framework
+
+To reduce application size, simplify package dependencies, and streamline servicing, .NET 11 includes nine `Microsoft.Extensions.*` libraries in the base shared framework. Projects that explicitly reference these packages receive build warning [NU1510](/nuget/reference/errors-and-warnings/nu1510). You can resolve the warning by removing the `PackageReference`. If you depend on an older version of these packages, upgrading to the .NET 11 version might expose previously undocumented breaking changes introduced between older versions and .NET 11.


upgrading to the .NET 11 version might expose previously undocumented breaking changes introduced between older versions and .NET 11

I believe these breaking changes were documented (the ones listed at the end of this article).

svick · 2026-05-12T09:26:06Z

+
+## Previous behavior
+
+Previously, the following `Microsoft.Extensions.*` libraries weren't part of the .NET base shared framework. Projects that needed them required explicit `PackageReference` entries, and the build process copied the assemblies to the output folder:


the .NET base shared framework

Is it worth mentioning that you get the shared framework by using Sdk="Microsoft.NET.Sdk", or similarly referencing any of the other SDKs?

Initial plan

c23b1d1

Copilot AI assigned Copilot and gewarren May 5, 2026

Copilot started work on behalf of gewarren May 5, 2026 19:05 View session

Copilot AI linked an issue May 5, 2026 that may be closed by this pull request

[Breaking change]: .NET 11+ shared framework includes Microsoft.Extensions.* Abstractions/Options/Primitives packages #52865

Open

3 tasks

dotnet-policy-service Bot added the okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings. label May 5, 2026

Add breaking change article: Microsoft.Extensions.* packages in share…

bc6b851

…d framework (.NET 11) Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

dotnet-policy-service Bot added the dotnet-fundamentals/svc label May 5, 2026

Address code review feedback: style improvements to breaking change a…

b042f5d

…rticle Agent-Logs-Url: https://github.com/dotnet/docs/sessions/e8635257-475f-450d-8351-50107ec8c6e1 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Fix issue with Microsoft.Extensions libraries in .NET 11+~~ docs: Breaking change — Microsoft.Extensions.* Abstractions/Options/Primitives in .NET 11 shared framework May 5, 2026

Copilot finished work on behalf of gewarren May 5, 2026 19:10

Copilot AI requested a review from gewarren May 5, 2026 19:10

gewarren marked this pull request as ready for review May 5, 2026 19:10

gewarren requested a review from a team as a code owner May 5, 2026 19:10

Copilot AI review requested due to automatic review settings May 5, 2026 19:10

Copilot started reviewing on behalf of gewarren May 5, 2026 19:11 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

gewarren approved these changes May 5, 2026

View reviewed changes

gewarren and others added 2 commits May 5, 2026 12:25

Apply suggestions from code review

e0598fa

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

Update docs/core/compatibility/extensions/11/extensions-in-shared-fra…

36fd9c6

…mework.md

Copilot started work on behalf of gewarren May 5, 2026 19:28 View session

Address reviewer feedback: NuGet links, front matter title, multi-tar…

2074387

…geting guidance Agent-Logs-Url: https://github.com/dotnet/docs/sessions/b2a02110-0ef1-4f11-be45-fec2c67a75d5 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot AI changed the title ~~docs: Breaking change — Microsoft.Extensions.* Abstractions/Options/Primitives in .NET 11 shared framework~~ docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework May 5, 2026

Copilot finished work on behalf of gewarren May 5, 2026 19:31

Copilot AI requested a review from gewarren May 5, 2026 19:31

gewarren requested review from a team and ericstj May 5, 2026 19:36

svick reviewed May 12, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework#53565

docs: Breaking change — Some Microsoft.Extensions packages in .NET 11 shared framework#53565
Copilot wants to merge 6 commits into
mainfrom
copilot/remove-unneeded-references-dotnet-11

Copilot AI commented May 5, 2026 •

edited by github-actions Bot

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gewarren commented May 5, 2026

Uh oh!

Copilot AI commented May 5, 2026

Uh oh!

svick May 12, 2026

Uh oh!

svick May 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		# Some Microsoft.Extensions packages included in shared framework

		To reduce application size, simplify package dependencies, and streamline servicing, .NET 11 includes nine `Microsoft.Extensions.*` libraries in the base shared framework. Projects that explicitly reference these packages receive build warning [NU1510](/nuget/reference/errors-and-warnings/nu1510). You can resolve the warning by removing the `PackageReference`. If you depend on an older version of these packages, upgrading to the .NET 11 version might expose previously undocumented breaking changes introduced between older versions and .NET 11.


		## Previous behavior

		Previously, the following `Microsoft.Extensions.*` libraries weren't part of the .NET base shared framework. Projects that needed them required explicit `PackageReference` entries, and the build process copied the assemblies to the output folder:

Conversation

Copilot AI commented May 5, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Internal previews

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gewarren commented May 5, 2026

Uh oh!

Copilot AI commented May 5, 2026

Uh oh!

svick May 12, 2026

Choose a reason for hiding this comment

Uh oh!

svick May 12, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented May 5, 2026 •

edited by github-actions Bot

Loading